API
Cette section décrit les fonctionnalités de base d'OLEM et l'API MicroPython associée. Chaque page explique une fonctionnalité, donne des exemples, puis liste ses constantes et ses fonctions.
Remarque : pour l'instant, toutes les fonctions sont dans un seul module nommé olem. Cela pourra changer plus tard, avec un module par groupe de fonctionnalités (un pour toutes les fonctions des LEDs par exemple).
Toutes les fonctions sont aussi listées sur une seule page dans la référence du module olem. Les descriptions des constantes et des fonctions sont générées à partir du kit de développement et ne sont disponibles qu'en anglais.
Déplacements
OLEM possède 3 roues holonomes qui lui permettent de se déplacer dans toutes les directions et de combiner librement les mouvements en (x, y, thêta).
LEDs
OLEM possède 6 LEDs RVB, une à chaque sommet. Elles peuvent servir à éclairer les zones sous OLEM. Leur numéro est indiqué sur l'image ci-dessous :
Temps
Exemple
Capteurs de sol
OLEM possède 6 capteurs qui détectent le sol en permanence. Ils renvoient un signal qui dépend de la couleur de la zone située juste sous le capteur : une surface blanche donne le signal le plus fort, une surface noire ou l'absence de surface le signal le plus faible.
Capteurs latéraux
Les capteurs latéraux permettent de détecter des objets proches d'OLEM. Ils les voient jusqu'à 150 mm en ligne droite depuis le capteur. [insérer une image de la zone de détection]
Capteur du dessus
Le capteur du dessus fonctionne comme un capteur latéral, sauf qu'il est… sur le dessus d'OLEM. Il détecte donc surtout les mains des joueurs et peut facilement servir de bouton.
Messagerie de jeu
Des données peuvent être échangées avec un appareil sans fil, sur un canal indépendant du shell normal. Le cas d'usage par défaut est l'application mobile pendant les parties, mais la messagerie permet aussi d'interagir avec un ordinateur via le Command Center.
Écran
L'écran d'OLEM est un écran LCD-TFT équipé d'une dalle tactile capacitive. Ses caractéristiques techniques sont :
Audio
Exemple
NFC
Le capteur NFC est placé sous OLEM, entre les deux roues avant. Il permet de lire les données des tags quand OLEM passe dessus. Quand la détection NFC est activée, OLEM lit tous les tags qu'il croise et stocke leurs données, qui peuvent ensuite être lues avec l'API ci-dessous.
Module d'extension
OLEM possède 4 emplacements d'extension, dont 2 sont équipés d'un connecteur qui permet d'ajouter à OLEM de nouvelles fonctionnalités nécessitant des composants électroniques. Les connecteurs ont 4 broches :
Système
Exemple